home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 2 / Atari Forever 2.zip / Atari Forever 2.iso / serie_v / v_329 / ctdlcnfg.sys < prev    next >
Text File  |  1987-04-21  |  15KB  |  323 lines
  1. *---------------------------------------------
  2. *
  3. * Written 8-Sep-87 by David Parsons (orc@pell 612-377-9239)
  4. *
  5. *---------------------------------------------
  6. *
  7. * CTDLCNFG.SYS -- STadel 3.1a configuration file.
  8. *
  9. *
  10. * This file is a valid CTDLCNFG.SYS -- the only lines that CONFIGUR.TOS
  11. * looks at are the lines that begin with #.
  12. *
  13. * Some commentary on fields:  The field names within quotes are string
  14. * fields -- you must put them in quotes.  Some of these string fields allow
  15. * C-type \ escapes in them (\r is C/R, \n is newline, \octal number is ascii
  16. * character <octal number> -- and you need to put in \\ if you want a single
  17. * \ in your string.):
  18. *
  19. *            #nodeTitle
  20. *            #baseRoom
  21. *            #callOutPrefix
  22. *            #callOutSuffix
  23. *            #modemSetup
  24. *            #reply300
  25. *            #reply1200
  26. *            #reply2400
  27. *            #reply9600
  28. *
  29. * To bring up your system, edit a copy of this file, run CONFIGUR.TOS, then
  30. * run CITADEL.TOS
  31. *
  32. * NOTE: All numbers in this file should be decimal.
  33. *
  34. *---------------------------------------------
  35.  
  36. #nodeTitle "Panther BBS"
  37. *
  38. * #nodeTitle is the name STadel gives when somebody does a .r(ead) s(tatus)
  39. * or when they connect to the system and you don't have a BANNER.BLB in your
  40. * help directory. (You must define this field.)
  41. *---------------------------------------------
  42.  
  43. #nodeName "HfH"                         * 19 characters max.
  44. #nodeId "US (555) 555-5555"             * 19 characters max.
  45. *
  46. * #nodeName is the name STadel uses during networking. Messages going from this
  47. * system to other systems will be tagged as coming from 'nodeName'.
  48. * #nodeId is the phone number of your system. Users will never see this field.
  49. * The node id should be in the form `XX (NNN) NNN-NNNN'
  50. *                                    ^    ^    ^
  51. *      country code (in COUNTRY.DOC)-+    |    |
  52. *      area code (for a USA number) ------+    |
  53. *      local number ---------------------------+
  54. *
  55. * both of these fields must be defined if your system networks.
  56. *---------------------------------------------
  57.  
  58. #baseRoom "Lobby"                       * 19 characters max.
  59. *
  60. * #baseRoom is the name of your Lobby> room. It's merely a convenience if you
  61. * don't like the name Rotunda> (or whatever name this version of STadel uses
  62. * for the lobby room.)
  63. *---------------------------------------------
  64.  
  65. #sysPassword "filename.ext"
  66. *
  67. * #sysPassword is for sysops who want remote access to sysop functions.
  68. * #sysPassword is the name of a FILE where the system password can be found.
  69. * The system password must be the first line of the file. For example, if you
  70. * define a #sysPassword of "a:\pass.wrd" and the first line of a:\pass.wrd
  71. * is Def.Ghi.Password, `Def.Ghi.Password' will be your system password.
  72. * (The system password must be at least 15 characters, too.)
  73. *---------------------------------------------
  74.  
  75. #sysop "Yourname"
  76. *
  77. * #sysop is a convenience for the sysop of the board.  If you set this field,
  78. * all mail to 'Sysop' will be sent to this person. (on Pell, I've got it set
  79. * as '#sysop "orc"' -- all mail to Sysop goes to me...)
  80. * If that person doesn't exist, Sysop mail will be put in the aide room just
  81. * like normal.
  82. *---------------------------------------------
  83.  
  84. #define LOGSIZE         100             * entries in the userlog
  85. #define CRYPTSEED       000             * black magic variable
  86. #define MESSAGEK        128
  87. *
  88. * LOGSIZE, CRYPTSEED, and MESSAGEK are all needed by STadel.  LOGSIZE is the
  89. * number of userlog entries you want on your system, MESSAGEK is the number
  90. * of Kbytes you want to have on the system (CONFIGUR rounds up to the next
  91. * multiple of 4), and CRYPTSEED is the system file encryption key.
  92. *
  93. * These fields CANNOT be changed after you have generated your system.  If you
  94. * want to expand your userlog or your messagebase, there are utilities written
  95. * to do that -- run then and follow the directions they give.
  96. *---------------------------------------------
  97.  
  98. #msgDir   "a:\msg"              * where the messagebase is
  99. #sysDir   "a:\sys"              * where system files go
  100. #helpDir  "a:\help"             * helpfiles are found here
  101. #auditDir "a:\audit"            * all auditing stuff goes here
  102. *
  103. * These fields are the names of directories that you MUST have defined to
  104. * generate a working STadel. #msgDir is where CTDLMSG.SYS goes (the
  105. * messagebase), #sysDir is where all the other system files (CTDLFLOOR.SYS,
  106. * CTDLROOM.SYS, CTDLLOG.SYS) go, #helpdir is where the system help files
  107. * can be found, and #auditDir is where various statistical files go.
  108. *---------------------------------------------
  109.  
  110. #netDir   "a:\net"              * where netfiles go
  111. *
  112. * if your STadel networks, this is where network files go. You must have this
  113. * directory defined if you network or use the UUCP gateway.
  114. *---------------------------------------------
  115.  
  116. #define MIRRORMSG       0               * don't use mirrormsg
  117. #mirrorDir "a:\"
  118. *
  119. * MIRRORMSG is for sysops who wish to put their messagebase onto a RAMDISK.
  120. * If MIRRORMSG is nonzero, STadel will write messages to CTDLMSG.SYS in
  121. * #msgDir AND in #mirrorDir, but only read from #msgDir
  122. *
  123. * If you're using MIRRORMSG, you must define #mirrorDir.
  124. *---------------------------------------------
  125.  
  126. #define CALL-LOG        1               * keep a call-log
  127. #define AUDIT-FILES     0               * but don't keep track of downloads
  128. #define AUDIT-CALLS     1
  129. #define AUDIT-EXIT      1
  130. *
  131. * If CALL-LOG is nonzero, STadel will keep a log of all the calls made to
  132. * the system in the file CALLLOG.SYS in the #auditDir.
  133. *
  134. * The three AUDIT- fields are for sysops who want to keep track of different
  135. * things:
  136. * o AUDIT-FILES keeps a record of all downloads (.rf) made by users.
  137. * o AUDIT-CALLS keeps a record of all logins on the system.
  138. * o AUDIT-EXIT  keeps a record of all the times the system goes up or down.
  139. *
  140. * If you define CALL-LOG, it is the same as defining AUDIT-CALLS and
  141. * AUDIT-EXIT.
  142. *
  143. *---------------------------------------------
  144.  
  145. #define RECEIPTK        80              * allow 80K inbound stuff
  146. #receiptDir "a:\receipt"                * in this directory
  147. *
  148. * One of the features in STadel is network sendfile -- systems can send
  149. * files during networking. So, if you're running the network, you need these
  150. * two defines.  RECEIPTK is the number of Kbytes you can have in your
  151. * #receiptDir (if you have more than RECEIPTK Kbytes, your system will
  152. * not accept files sent from another system during networking)
  153. * #receiptDir is where these files are put.
  154. *---------------------------------------------
  155.  
  156. #shell "\pcommand.prg"                  * shell name   
  157. *
  158. * #shell is the full pathname of the shell to execute when you do an [O]utside
  159. * command from the sysop menu.  If this field is not defined, you can't use
  160. * [O]utside commands.
  161. *---------------------------------------------
  162.  
  163. #define LOGINOK 1                       * anybody can log in
  164. #define READOK  0                       * unlogged people can't read msgs
  165. #define ENTEROK 0                       * unlogged people can't enter msgs
  166. #define ROOMOK  1                       * everybody can create rooms
  167. #define ALLMAIL 1                       * everybody can send email
  168. #define ALLNET  0                       * don't give new users net privileges
  169. #define PARANOID 0                      * I'm not paranoid -- are you?
  170. *
  171. * These fields are pretty self-explainatory. They are all switches -- nonzero
  172. * means they are TRUE and zero means they are FALSE.
  173. *
  174. * PARANOID governs the login behavior of STadel. If PARANOID is nonzero, STadel
  175. * will not allow callers onto the system until they enter both their name and
  176. * their password.
  177. *---------------------------------------------
  178.  
  179. #define NETWORK         1               * enable networking
  180. *
  181. * NETWORK tells STadel whether to do networking or not.  If it's zero, STadel
  182. * will not allow any networking commands and will not try to do networking
  183. * sessions.
  184. *---------------------------------------------
  185.  
  186. #define USA     1                       * north american system.
  187. #define LOCAL-TIME      30              * wait 30 seconds for local calls to
  188.                                         * time out.
  189. #define LD-TIME 60                      *  ... 60 seconds for l-d calls.
  190.  
  191. *
  192. * USA tells STadel whether this system is in North America or not.  If USA
  193. * is nonzero, STadel will prefix long-distance calls with `1' and remove
  194. * the first 3 digits in the network ID for making local calls.
  195. *
  196. * LOCAL-TIME is how long it takes STadel to time out when making a local call.
  197. * If defaults to 20 seconds.
  198. *
  199. * LD-TIME is how long it takes STadel to time out when making a long-distance
  200. * call.  It defaults to 50 seconds.
  201. *
  202. * (Apologies to Canadian [and Mexican?] STadel operators for using USA as a
  203. * synonym for North American....  `USA' is shorter, so laziness takes
  204. * precedence over accuracy.)
  205. *---------------------------------------------
  206.  
  207. #callOutPrefix "ATDT"
  208. #callOutSuffix "\r"
  209. *
  210. * #callOutPrefix and #callOutSuffix are for networking call-out.  When calling
  211. * another system, STadel will send the modem the callOutPrefix, the number to
  212. * call, and the callOutSuffix.  For example, if you're using the prefix and
  213. * suffix in this example file, your system will send the string ATDT<number>\r
  214. * to the modem when it tries to call a system at <number>.
  215. * If your system networks, you must define these.
  216. *---------------------------------------------
  217.  
  218. #define SEARCHBAUD      1               * do autobaud searching
  219. #define CONNECTPROMPT   0               * don't ask the user to hit C/R
  220. #define CONNECTDELAY    0               * modem doesn't need to stabilize
  221. #define SYSBAUD         1               * a 300/1200 baud system
  222. *
  223. * SEARCHBAUD tells the system whether to do baud rate searching.  If the
  224. * system does baud-rate searching, it will loop through the baudrates --
  225. * waiting half a second at each baud rate for a C/R -- until a C/R is detected
  226. * or 60 seconds are up. If SEARCHBAUD is zero, STadel will assume that the
  227. * modem only works at SYSBAUD baud rate (see below for a description of the
  228. * permissible baud-rate codes.)
  229. *
  230. * CONNECTPROMPT changes the behavior of SEACHBAUD.  If CONNECTPROMPT is
  231. * nonzero, STadel will prompt the user to hit C/R, then wait 10 seconds for
  232. * one, for each baudrate.
  233. *
  234. * CONNECTDELAY is the number of seconds that the computer needs to wait for
  235. * the modem to stabilize before it starts baud-rate searching. (Some modems
  236. * will drop carrier if you send a character out the modem too soon after
  237. * somebody calls in)
  238. *
  239. * SYSBAUD is the range of baud-rates that the system will support. (If
  240. * SEARCHBAUD is zero, it's the only* baud rate the system will support.)
  241. * This field MUST be defined.
  242. * SYSBAUD ranges from 0 to 3 -- 0 is 300 baud, 1 is 1200/300, 2 is
  243. * 2400/1200/300, and 3 is 9600/2400/1200/300.
  244. *---------------------------------------------
  245.  
  246.  
  247. #modemSetup "AT V0 X1 E0 F1 M0 Q0 S2=255 S7=60\r"
  248. *
  249. * #modemSetup is the string that STadel sends to the modem when it initialises
  250. * if.  This field must be defined.
  251. *
  252. *---------------------------------------------
  253.  
  254. #reply300  "1"
  255. #reply1200 "5"
  256. #reply2400 "2400 baud reply"
  257. #reply9600 "9600 baud reply"
  258. *
  259. * If your modem is capable of returning reply strings to tell you what
  260. * baud-rate an incoming call is at, you can bypass the normal STadel
  261. * baud-rate searching code by defining these fields and setting your
  262. * modem up so that it returns the codes (this will involve changing
  263. * your #modemSetup so that it doesn't disable that feature.)
  264. *
  265. * For the baud-rate detection magic to work, the reply strings that
  266. * the modem returns must be terminated by a \r.  However, when you
  267. * set up the #reply strings, don't* include the \r in the string --
  268. * if the modem sends a "1\r" back for a 300 baud connect, your
  269. * #reply300 should be "1", NOT* "1\r"
  270. *
  271. * #reply300  -- the reply the modem gives when a 300 baud caller is detected.
  272. * #reply1200 -- the reply the modem gives when a 1200 baud caller is detected.
  273. * #reply2400 -- the reply the modem gives when a 2400 baud caller is detected.
  274. * #reply9600 -- the reply the modem gives when a 9600 baud caller is detected.
  275. *
  276. * This feature has only been tested on Hayes compatable modems.  If you're
  277. * working with other types of modems and you get them to work properly, let
  278. * me (orc@pell 612-377-9239) know about it, please.
  279. *---------------------------------------------
  280.  
  281. #event PREEMPTIVE  3:00  0 uucp    10   * try UUCP at night
  282. #event NETWORK     3:01 39 network  0   * normal networking
  283. #event TIMEOUT    15:00  0 uucp    10   * try UUCP during the afternoon.
  284. *
  285. * Events are how STadel interrupts itself to do various things.  There are
  286. * three types of event -- PREEMPTIVE, NETWORK, and TIMEOUT.  A NETWORK event
  287. * has STadel take over the system and run the networker at the time specified,
  288. * a PREEMPTIVE event has STadel take over the system and exit to the outside
  289. * world at the time specified, and a TIMEOUT event has STadel exit to the 
  290. * outside world as soon as it at the time specified (if somebody is using
  291. * the system when this event goes off, a timeout won't kick them off.)
  292. *
  293. * The six fields in a #event line are as follows:
  294. *
  295. * #event <whatever> <time> <duration> <name> <flags>
  296. *
  297. * <whatever> is PREEMPTIVE, NETWORK, or TIMEOUT.
  298. * <time> is when the event is scheduled to go off (in 24-hour time... 3:00pm is
  299. * 15:00)
  300. * <duration> is how long the event is supposed to last -- if STadel is brought
  301. * up after the start of an event but before the event is supposed to be over,
  302. * it will immediately do the event.
  303. * name is the ascii name of the event (under 20 alphanumeric characters.)
  304. * <flags> depends on the type of event.  If it is a NETWORK event, <flags> is
  305. * which network is gonna be run (this is fairly advanced stuff -- just use
  306. * 0 for casual sysopping), otherwise it is the condition code that STadel
  307. * returns to the calling program. (don't* use 0,1,2, or 3 -- these are already
  308. * defined within STadel.)
  309. *
  310. * In the twin cities, STadels (and Amiga Citadels and MS-DOS citadels) network
  311. * at 3:00am for 45 minutes.
  312. *---------------------------------------------
  313.  
  314. #define TIMEOUT 0
  315. #define HOUROUT 0
  316. *
  317. * Timeout and hourout are another type of event STadel has -- if you've got
  318. * TIMEOUT set (nonzero), STadel will have a TIMEOUT event HOUROUT hours
  319. * after the system is brought up.  (returning a condition code of 1 to the
  320. * calling program.)  This is handy for doing backups.
  321. *---------------------------------------------
  322. * EOF *
  323.